package com.telecom.mapper;

import com.telecom.pojo.entity.RechargeRecord;
import com.telecom.pojo.vo.admin.finance.RechargeRecordVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDate;
import java.util.List;

/**
 * <p>
 * 充值记录表 Mapper 接口
 * </p>
 *
 * @author GWX.cz
 * @since 2025-07-31
 */
@Mapper
public interface RechargeRecordMapper {

    /**
     * 插入充值记录
     * 
     * @param rechargeRecord 充值记录
     * @return 插入的行数
     */
    int insert(RechargeRecord rechargeRecord);
    
    /**
     * 充值记录分页查询（配合PageHelper使用）
     * 
     * @param transactionIdOrUsername 交易ID或用户名（可选）
     * @param date 日期（可选）
     * @return 充值记录列表
     */
    List<RechargeRecordVO> selectRechargeRecordPage(@Param("transactionIdOrUsername") String transactionIdOrUsername, 
                                                   @Param("date") LocalDate date);
}
